Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / TS_SE02C.ZIP / TSHOP.DOC < prev next >

Wrap

Text File | 1996-03-20 | 96.4 KB | 2,124 lines

┌────────────────────────────────────────────────────────────────────────────┐ │ ┌─═══════╗ │ │ │ ║ █ │ │ │ ║ █▀▀▌ █▀▌█ █▐▀█▐▀█ █▀▀█ █ █ █▀▌█ █▀▌█ █▀▀▌ │ │ │ ║ █ █ █ █ █ █ █ █ █ █ ▀▀ █ █ █ █ █ │ │ ┌══════┘ ╚══════╗ █▄▄█ █▄▄█ █ █ █ █▐▄█ █▐▄█ █▄▄█ █▄▄█ █▄▄█ │ │ │ ║ █ Consulting │ │ │ ║ │ │ │ ║ Affordable, Quality Doorware for all BBS types. │ │ ╘──────┐ ╓──────╜ │ │ │ ║ 1840 Haverhill Drive, Virginia Beach, VA 23456 │ │ │ ║ Voice (804) 468 - 1684 │ │ │ ║ BBS (804) 468 - 1783 / 1492 / 1386 │ │ └────────╜ │ │ │ └────────────────────────────────────────────────────────────────────────────┘ Copyright(c) 1991-96 Compu-Doc Consulting All Rights Reserved ╔═╦═╗ ╦══╗ ╦═ ╦══╗ ╔══╗ ╦ ╦ ╔══╗ ╦══╗ ╦══╗ ╦══╗ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╠═ ║ ╠═ ╚══╗ ╠══╣ ║ ║ ╠══╝ ╠══╝ ╠═ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╩ ╩══╝ ╩══╝ ╩══╝ ╚══╝ ╩ ╩ ╚══╝ ╩ ╩ ╩══╝(TM) The COMPLETE On-Line Shopping System for all types of Bulletin Boards. Version SE02 Created By Gary R. Smith Copyright (c) 1991-96 - Compu-Doc Consulting Documentation for Single and MultiNode Versions License to Use Agreement ─────────────────────────────────────────────────────────────────────── Compu-Doc Consulting, (hereafter referred to as"CDC"), grants to the purchaser - and purchaser accepts - a non-transferable and nonexclusive license to use, on a single computer, the software products and accompanying materials provided to the purchaser by CDC. Purchaser is hereby licensed only to read the program from its medium into the memory of a single computer solely for the purpose of executing the program. CDC shall have the right to terminate this license if purchaser violates any of its provisions. Purchaser agrees that the software products and accompanying materials are the property of CDC and that CDC shall maintain title to and ownership of the software products at all times. Purchaser agrees to make no more than one (1) additional working copy and one (1) backup copy of the software products for their personal use only. CDC makes no warranties of any kind, expressed or implied, with respect to the quality, performance, accuracy, or fitness of the software products for any particular purpose. CDC assumes no responsibility for any decisions make or actions taken on the part of the purchaser because of the use of the software products. In no event shall CDC, or any of its representatives, be liable for any loss of profit or any other damages, arising out of the use or inability to use this product - even if CDC or an authorized agent of such has been advised of the possibility of such damages - or for any claim by any other party. CDC reserves the right to make changes, enhancements and improvements to the software products at any time without notice. DISCLAIMER ─────────────────────────────────────────────────────────────── There is made no warranty of any kind, express or implied including, without limitation, any warranties of merchantability and / or fitness for a particular purpose. CDC shall not be liable for any damages, whether direct, indirect, special or sequential arising from a failure of this program to operate in the manner desired by the User. CDC shall not be liable for any damage to data or property which may be caused directly or indirectly by the User of this program. IN NO EVENT WILL CDC BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. TeleShoppe(tm) is a Registered Trademark of Compu-Doc Consulting Borland C++ is a Registered Trademark of Borland International CKIT is a Trademark of Data-Comp Information Systems PCBoard is a Registered Trademark of Clark Development Company TeleShoppe SE02 INTRODUCTION ────────────────────────────────────────────────────────────────────────── Features of TeleShoppe SE02: o Versatile Database can be used to sell anything! o Use a catalog! Users can enter just a stock number and find their products they want instantly! o User-friendly interfaces for both the SYSOP and the User! o Sysop can design his own screens using @ color codes! o Extended Descriptions allow for detailed explanations of each item. o Internal Editor for inputing extended descriptions! o Configurable shipping matrix with weight for each item in the Database. o Break Points for any price range! o Unlimited Database size! o Unlimited Categories! o Fast, indexed item listings. o Item Search conducted from command line! o Downloadable Quotes and Invoices! o Configurable to accept Visa, MasterCard, American Express, and many more popular credit cards! o Instantly verifies different card types by actual computation! o Accept CHECKS online using ANY service! o Can operate at speeds in excess of 115,000 Baud! ---------------------- Upgrading Information When you purchase TeleShoppe you will receive a REGISTRATION NUMBER that will remove all the "EVALUATION COPY" lines and small pauses from the version you are using. There are no time restrictions placed on a particular version of TeleShoppe. (NO annual fees. NO Key files that die out on you after a short time. You OWN this version!) Bug fixes and amendments are free and may be downloaded from the Support BBS. Subsequent releases will be available at a reduced Upgrade price for Registered Users. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Setting Up TeleShoppe If you have never set up Doorware for Bulletin Board Systems, we will walk you through some of the most basic procedures to ensure that you properly configure TeleShoppe with minimum work and time. For those of you who are experienced Sysops, please bear with us! Creating a TeleShoppe provides its own INSTALL program. This will directory make your installation almost totally automatic. To install unzip your TSHOPxxxx zip file into a temporary directory. Then Type Install. You are asked for the starting directory which should already be typed in for you providing you started in the temporary directory. Type: INSTALL to run installation program Next tab down (or use the arrow keys) to the destination field. This is the directory where you want install to perform the installation. Like the following example: C:\PCB\DOORS\TSHOP Copy the When completed typing in the destination directory, Press files the F10 key when your ready to proceed. If the directory does not exist, install will ask you if its ok to create it and the complete sub-directory structure from which TeleShoppe will operate. Press Y to continue. Install will copy all the necessary files over to your specified directory. * │ NOTE: To find the version of each TeleShoppe file you are │ running, check the File Creation Time. If the file │ creation time is 0:01, you have version SE02 of TeleShoppe. │ If the time is 2:13 then you would be running version 2.13 │ of TeleShoppe. (Please have this version number ready when │ calling our Support Line or BBS for assistance.) * Install is now complete and you can move on to the next step. Construct To run TeleShoppe from most Bulletin Boards, you will a batch file need to construct a Batch file that your Bulletin Board Software will use to call the TeleShoppe program. If you are running multi-nodes (and have the multi-node version of TeleShoppe) you will want to make use of environment variables provided by your software. (Note: DO NOT use TeleShoppe in a multi-node setting if you only own the single node version (Registered Version) (The unregisterd version is a fully working multiple node copy) - file corruption will occur!) By creating this batch file, you are configuring it so TeleShoppe will run for that node. Each Batch file you create should be similar to the following example. (We are assuming you are configuring for a single node.) TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── A sample TSHOP file can be found in your TeleShoppe Directory. --------------------------------------------------------- Single Node Name of batch file: TSHOP Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\TSHOP Line 3 TSHOP.EXE C:\PCB\PCBOARD.SYS Line 4 CD C:\PCB Line 5 BOARD --------------------------------------------------------- Multi-Node Name of batch file: TSHOP Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\TSHOP Line 3 TSHOP.EXE %PCBDRIVE%%PCBDIR%\PCBOARD.SYS Line 4 CD %PCBDIR% Line 5 Board (BBS COMMAND) --------------------------------------------------------- Other BBS Version (Other than PCBoard) Line 1 @ECHO OFF Line 2 CD C:\BBS\DOORS\TSHOP Line 3 TSHOP.EXE DOOR.SYS Line 4 CD C:\BBS Line 5 BBS COMMAND * │ NOTE: For Non-PCBoard systems that are running nodes, you │ can set environment variables that will allow you to take │ advantage of the above situations. │ │ In your system's AUTOEXEC.BAT file, define your drive and │ directory of your DOOR.SYS files. For example: │ │ SET BBSDRIVE=C: │ SET BBSDIR=\WILDCAT │ │ To use the above variables, you would use the DOS %variables │ in your Batch file as: │ │ Line 3 TSHOP.EXE %BBSDRIVE%%BBSDIR%\DOOR.SYS │ │ This will allow TeleShoppe to determine exactly where the │ NODES files are located. To return to the home directory, │ you would add the following lines to the Batch file: │ │ %BBSDRIVE% //Change back to the original drive │ CD %BBSDIR% //Change to the original directory │ <Board.bat> //Call the board again * TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Meanings: Line 1 Turns off the local screen echo (Dos 3.3 and above) Line 2 Changes to the directory where TeleShoppe is stored. Line 3 (1) TeleShoppe executable statement (2) The complete path to that nodes PCBoard.sys, DOOR.SYS etc.. Line 4 Changes back to the Bulletin Board's main directory. (Where the BBS is run from) Line 5 The BBS Command (Board in the case of PCBoard) * │ NOTE: Your TeleShoppe batch file should be similar to the │ examples above. Line 3, however, must contain the path to │ the PCBOARD.SYS or DOOR.SYS-type file. * This file is to be placed in the PCBoard or BBS directory. Adding to The next step for setting up TeleShoppe is to add it to BBS Doors your Bulletin Board's Doors file. If you use PCBoard, this file is performed through the PCBoard SETUP program. In the PCBSETUP Editor for Doors, place the name of the Batch file you just created above in a slot for a door, give it a minimum security level, and you're finished. If you prefer to use the DOOR.SYS information, make sure you select to create a DOOR.SYS file. You should select NO SHELL in the PCBoard setup. You may use either DOOR.SYS, PCBOARD.SYS or other popular door dropfiles. (NOT RBBS, SORRY) Memory - If you have a problem and TCONFIG returns an error of 112, you will have to set a variable pointing to a temp directory in your enviornment. ie..In your autoexec.bat file put the line (or similiar) SET TEMP=C:\TEMP (any directory that exists can be used) This is done so that if need be, TCONFIG can swap out to disk if XMS memory is not available. This completes the basic setup of TeleShoppe. Please read further to configure TeleShoppe to run with your Database and software. You are now ready to utilize the configuration program (TCONFIG). This program will assist you in setting up your configuration file (TSHOP.CNF). You must use the configuration program (TCONFIG.EXE) to edit the TSHOP.CNF file to avoid any problems with incorrect configu- rations. TCONFIG, as you will see, is more than just a config file writer. It is also the heart of the Database management/creation center. From TCONFIG you can perform all of your maintenance for TeleShoppe. TeleShoppe can work on any 100% IBM compatible system. The basic hardware requirements are listed below: IBM Processor 8088 or better Hard drive (Recommend 20 meg or better) Mono, EGA, VGA, SVGA Monitor 1200 or higher speed modem (Up to 115000 Baud) TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── The TCONFIG file must be executed from TeleShoppe's own directory. If not, you will re-create all the necessary files to run TeleShoppe as defaults in whatever directory you are in. To begin, type TCONFIG from the command line. Main Menu HELP Context-sensitive help is provided throughout the TCONFIG program. When you are at an item that you desire some help, or need to know what the defaults would be, press F1. Pressing F1 will bring up to the screen a help index system. By pressing Index, You can navigate anywhere's in the help system with a single key stroke. 1. CONFIGURATION Basic system information is entered in this portion of the program. Listed below is a description of each line item and what should be placed in the appropriate box. BOARDNAME - Place the name of your Bulletin Board System on this line. You have a maximum of 50 characters. (This should match your registration name exactly. If not, contact the Support Board for new registration information). REGISTRATION NUMBER - Place the registration number you received from CDC or the Support Board on this line. If you have not registered your version of TeleShoppe, Place 00000 on this line - or leave the default. CARD PROCESSOR - Place the name of your card processor on this line. (This is the name of the company that appears on the Users credit card statement.) 2. FINANCIAL INFORMATION Most of TeleShoppe's financial information is contained in this area. Other financial data may be found in Item #3 of the Main Menu (Misc/Shipping). CREDIT CARDS ACCEPTED - Here you will find the list of credit cards that TeleShoppe automatically checks for validity. Along each side you must enter either a "Y" or a "N" to indicate that you will or will not accept the card from your Users. Each card must be set individually. * │ NOTE: There is extensive card checking incorporated │ within TeleShoppe to validate credit cards. We cannot, │ however, guarantee that the User is not using a card │ that is over the credit limit, stolen, etc. All cards │ are checked using a modulus math routine, length and │ validation numbers. * TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── * │ NOTE: Credit cards are not mandatory and may be turned │ off in Main Menu Item #3. * USE BREAK POINT AVERAGES - Enter a "Y" or "N" to use the Break Point averages listed to the right of the screen. * │ NOTE: Break Points are used when the retailer wants to │ give a percentage price break for quantity buying. (See │ Break Points below for information on how to use them.) * HANDLING PERCENTAGE - Place the percentage that you will charge for credit card handling, or other handling charges you are applying, on this line. (The value listed here is a percentage.) This percentage is used if there is no standard charge being used (See Misc Section) The decimal point MUST be included on this line. The handling charges are based on the following formula: Total = (Total Charges * Handling) + Total Charges If no handling charge is to be made then place .00 on this line (Default) TAX PERCENTAGE - Place the percentage of tax that your State/Province etc. places on taxable goods. If no tax is ever to be charged for the products you offer then place .00 (Default) in this field, otherwise place the appropriate amount here. The decimal point MUST be included on this line. The tax charges are based on the following formula: Total = (Total Charges * Tax) + Total Charges + Handling VARIABLE ADDED TAX - If your country places a VAT on different goods, TeleShoppe will now handle these products properly. Place the percentage of tax placed on VAT items. (There are entries in the Database to mark whether that particular item will receive the VAT applied to it or not) The decimal point MUST be included on this line. The VAT charges are based on the following formula: (Item Total * VAT) = TotalVat If no Variable Added Tax is to be used, then place .00 in this position. GOV SALES TAX (GST) - If your country places a GST on goods, TeleShoppe will now handle these products properly. Place the percentage of tax for GST. The decimal point MUST be included on this line. The VAT charges are based on the following formula: (Total * GST) = TotalGST TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── If no GST is to be used, then place .00 in this position. Province State TAX - If your country places a PST on different goods in your province, TeleShoppe will now handle these products properly. Place the percentage of tax placed on PST items. The decimal point MUST be included on this line. The PST charges are based on the following formula: (Item Total * PST) = TotalPST To ensure PST is also added to all items you must place a 'Y' in the "Apply PST to purchases" section next to the amount. If no PST is added then place .00 in this position and a 'N' in the "Apply PST to purchases" section. STATE TO CHARGE TAX - The two (2) letter state designator for your state should be placed on this line - if your state requires that you charge sales tax. The following codes may be substituted to personalize your system, regardless of what country you are in. ALL - Charge all Users tax regardless of state/ province. By placing the word ALL on this line, everyone that purchases something will be charged tax. This could be used if the country charges a luxury tax on all items and does not charge different provinces different amounts. NO - Charge no User regardless of state/ province any tax. This will cause all Users regardless of where they are from to be charged no tax. TWO CHARACTER STATE - If TeleShoppe finds a two letter state code here and it matches with the Users indicated home state then that User alone will be charged tax. If the two states do not match, that User is not charged tax. In most cases you will place your state letter designator here since most states charge sales tax. * │ NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING │ 'F10' WILL SAVE THE ENTRIES TO DISK. * ALLOW TAX EXEMPTION STATUS - If you have users that are exempt from paying state taxes (ie, wholesalers, retailers etc) then entering a Y)es here will allow that user to purchase items without any state tax being entered. BREAK POINT (1-10) - If you desire to give your customers a price break for quantity buying you may do so automatically by entering the appropriate information in the Break Point area. A BREAK POINT is a percentage value that, if a buyer is within the range of two dollar values, will be charged that percentage assigned instead of the markup percentage assigned in the Database for that particular sale. With that said, let's give you a simple example: TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── In the Database you have Monitors priced at 50.00 with a markup percentage of 30% (.30). You have decided that customers who purchase items over 200 dollars will be automatically eligible for a markup of only 28%. To handle this you will put the following values in the BREAK POINT area: Max Pct Break Point 1.........200 .28 Break Point 2.........500 .25 The above matrix allows for all purchases under $200 to be assigned the markup value in the Database. All purchases between $200.00 and $499.99 will be charged a .28% markup instead of the markup assigned in the Database. * │ NOTE: On some purchases - because of the way your │ individual markup may be on items - the Break Point │ purchase could be more than the regular price. In this │ instance, No break price would be shown to the caller. * The same is with purchases above $500.00, They would be eligible for the 25% value in the Break Point area. If Break Points are not desired, Just enter a "N" in the appropriate block on this screen. SAVING AND ABORTING - To save the information you have entered on the screen, Press F10, to abort any changed information Press ESC. 3. MISC/SHIPPING TeleShoppe's Miscellaneous and Shipping Information is kept within this area of TCONFIG. To save your information when completed, Press F10. To abort or cancel any changed information, Press ESC. ALLOW THE USE OF COD - If will allow your Users the option of having their merchandise shipped Cash On Delivery (COD), place a "Y" in this block. If not you must enter "N" in this position. * │ NOTE: Your selections will be presented to your users │ as you have selected. These items are adjusted │ automatically and does not give the User the chance to │ input wrongful payment type. * ALLOW THE USE OF MONEY ORDERS - To allow Users to purchase items with money orders place a "Y" in this area, otherwise place a "N" here. ALLOW THE USE OF CREDIT CARDS - If you are going to allow your Users to use credit cards on your system then place a "Y" here and a "N" if you will not. Credit cards that are to be accepted should be configured under Main Menu Item #2 (Financial Information). TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── ALLOW THE USE OF CHECKS - To allow Users to purchase items with checks place a "Y" in this area, otherwise place a "N" here. (Ensure you edit the Checking OPTIONS section under the main menu) APPLY HANDLING TO COD - If you will apply the handling percentage assigned in Main Menu Item #2 to all COD requests, place a "Y" here. If not, place a "N" in this area. * │ NOTE: COD handling charges can be better handled by using │ the shipping matrix provided. However, this field is still │ presented for your use. * APPLY HANDLING TO MO - If you will apply the handling percentage assigned in Main Menu Item #2 to MONEY ORDER purchases, place a "Y" here, otherwise place a "N" in this field. APPLY HANDLING TO CCARDS - If you wish to apply the handling charge assigned under Main Menu Item #2 to all CREDIT CARD orders then place a "Y" in this field. If not, enter "N". APPLY HANDLING TO CHECKS - If you wish to apply the handling charge assigned under Main Menu Item #2 to all CHECK orders then place a "Y" in this field. If not, enter "N". STANDARD CHARGE - If you wish to charge a standard rate instead of having it use a calculated expense (Using the handling % under the Financial Section), enter a number larger than 0.00 here. This will be the only charge applied for handling regardless of the amount purchased. Invoice FILENAME - This file name is the name of the file that contains the format of the Invoice file you designed using the TeleShoppe @ codes. (Examples of this file are contained in the file INVOICE.TXT found in your main TSHOP directory). This file is read and when TeleShoppe encounters the "@" codes, it will replace the code with the substitution variable information requested. Example: If in your Invoice.TXT file you place: @FNAME@ conducted a purchase and John Smith was on line....TeleShoppe would write the Invoice as: John Smith conducted a purchase. Using this method you design your Invoice file in any manner you wish. This is the file that you will use to conduct your business with, it is not erased as is the receipt file. (More on this later). * │ NOTE: A complete listing of all TeleShoppe @ codes is │ available in the APPENDIX. * TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── RECEIPT FILENAME - This file is presented to the User online as a Receipt or Quote. This file is designed in the same manner as the Invoice.TXT file. The receipt file can contain TeleShoppe @ codes and designed to fit your needs. If in your RECEIPT.TXT file you place: @FNAME@ conducted a purchase and John Smith was on line....TeleShoppe would write the Invoice as: John Smith conducted a purchase. * │ NOTE: THIS FILE IS DELETED UPON THE User DEPARTING │ THE DOOR. * This file may be downloaded as a Quote or as a Receipt after a purchase is completed. * │ NOTE: Unless the User has entered personal data before, │ tax information will not be computed since the state of the │ person is not used. (On Quotes Only) * SHIPPING INFORMATION The shipping matrix provided with TeleShoppe was designed to be simple to use and implement. Knowing that this system is being used all over the world, a simple but somewhat effective method had to be devised. We feel that we have accomplished this. (More elaborate systems exist - but do not accommodate many of the other countries of the world.) SHIPPING (1 - 5) - Place the name of the carrier in this block. You can have up to 5 shipping types or vendors, such as: UPS BLUE, UPS OVERNIGHT, FEDEX, FEDEX RED, US MAIL, etc. You are allowed up to 15 characters for each entry. * │ NOTE: Remember by pressing F1 you can have context │ sensitive help! * BASE RATE - Enter the base rate that any purchase will receive for using this vendor/method of shipping. If all purchases should receive a minimum of a $3.00 charge, then place 3.00 here. (See the example after the explanations) MAXIMUM WEIGHT - This is the maximum weight that an item can weigh and still receive the charge of BASE RATE. If an item's weight is equal to or less than this weight, then only the BASE RATE will be charged. CHARGE PER OZ - This is the price per ounce that will be added for an item that is over the MAXIMUM WEIGHT amount. (*ratio) TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Example: Your User selects to use MA & PA shipping, which you have assigned the values of: 2.00 to Base Rate, 5 lbs for MAXIMUM WEIGHT and .0625 for CHARGE PER OZ. (.0625 * 16 = 1$ per pound charge). If the User selects a package that weighs in at 1.5 lbs, then the User will be charged $2.00 for shipping. (Minimum Amount) If the User selects a package that weighs in at 1 lb. and orders two of the same product, the User will be charged $2.00 (Max charge) for shipping, since the total weight of LIKE items is less than the MAXIMUM WEIGHT. If the User selects 4 of those items at 1.5 lbs each then the User is charged $2.00 for maximum weight charge, and then the remainder of the weight is multiplied by the Charge per oz. figure (16 oz per LB) to come up with the remaining amount. In this example 6 (4x1.5) - 5 = 1 (Extra weight) * .625 (Charge Per Oz) = 1.00 Make sense? Lets examine this. If you have 4 items at 1.5 lbs each, that gives you a total of 6 lbs. Maximum weight was 5 lbs - so the difference between 6 and 5 lbs is 1 lp. That one lp (consisting of 16 oz) is multiplied by .0625, which will yield a charge of $1.00. When applied to the BASE RATE yields a shipping charge of $3.00. The CHARGE PER OZ is a ratio that is multiplied by 16 (oz) to provide the charge for all weights exceeding the MAXIMUM WEIGHT amount. Using .0625 * 16 yields 1 dollar per pound. NOTE: Shipping is calculated on individual items, item weights are NOT combined to yield the final weight except on the same item. USE BASE RATE ONLY - If a Y)es is in this field then only the base rate will be charged and the shipping will not be calculated. This amount will be charged to all orders regardless of weight. 4. Database MAINTENANCE This option is where you will enter all of your Database information. If you not yet created a Database, please skip ahead to Main Menu Item #8 (Create A Database). Entering information in this area without first creating a Database could damage other TeleShoppe system files. Once entering the Database area, you must create your first record. This is accomplished by pressing the INSERT key and adding the appropriate data. After completing the first record you can press F10 to save the information or ESC to abort the entries. Database operation will be discussed in greater detail after the remarks. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Scrolling - There are two different options when scrolling through the Database. You may scroll in either record number order or by category order (Alphabetical). The following is a listing of the keys and their operations within the Database MAINTENANCE section). KEY OPERATIONS ALT+F [FIND] When this combination is pressed, TCONFIG will search for a certain pattern in the CATEGORY FIELD. ALT+G [GOTO] When this combination is pressed, TCONFIG will ask you for the record number to jump to. ALT+R Repeats the search for the next record (Forward) ALT+B Repeats the search for the next record (Reverse) F2 - [EDIT] When this key is pressed the Database record you are currently positioned at is placed in the Edit Mode. You then may change any field within the record. Pressing F10 when in Edit Mode will save the entries. Pressing 'ESC' will abandon the operation. F3 - EDITOR - When viewing a record on screen, you can display (EDIT) the extended descriptions by pressing the F3 key. This will bring up the pop Editor contained within TCONFIG that allows editing of extended descriptions. EXTENDED DESCRIPTIONS - These are the descriptions that are shown to the User when they select V)iew from the command prompt in TeleShoppe. Any text that is contained within the first 10 LINES is shown to the User, all text below the 10th line is maintained as a Comment for the Sysop. The key operations while in the editor are: Enter Insert line Home Go to beginning of line End Go to end of line Left Move one char left Right Move one char right Up Move up one line Down Move down one line PgUp Move up one screen full PgDn Move down one screen Ins Toggle Insert/Overwrite Del Delete character BkSpace Delete previous character Ctrl-BkSpace Delete word Ctrl-Y Delete Line Ctrl-Grey(-) Delete to end of line Alt-S Save extended description Alt-X Quit editor (Save if changed) TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── F4 - [Set Viewing Mode] This key allows you to toggle between record number order or by category order. The order you are in is displayed in the lower right hand corner of the display. (Categories are sorted alphabetically.) F6 - [Today's Date] When this key is depressed, the current date is placed in the field you are in. It is meant to be used with the Lastdate field. F10 - [SAVE] When F10 is pressed the edited fields are saved to disk. To avoid saving, just press ESC. ESC - [Abort] Pressing ESC will abort the current operation or, if you are in the viewing mode, pressing ESC will place you back at the Main Menu. PgUp - Moves you through the Database by increasing the records by 10. PgDn - Moves you thorough the Database by decreasing the records by 10. Ins - [INSERT] By pressing the Insert key when you are in the editing mode you will be able to INSERT a new record. You are automatically placed in the Editing mode once this key has been pressed. Del - [DELETE] By pressing the delete key you will mark a record for deletion. Fields within TeleShoppe The following is the structure used for the TeleShoppe Database. FieldName Type Size Decimals CATEGORY C 15 N/A NOMENCLA C 35 N/A COST N 15 2 LASTDATE D 8 N/A MARKUP N 10 3 STOCKNO C 25 N/A VENDER C 25 N/A DBVERSION C 15 N/A MANUFACTU C 15 N/A VTAX C 1 N/A GST C 1 N/A WEIGHT N 10 3 GIFNAME C 12 N/A DBTEXT M 10 N/A ( C - Character, N - Numeric, D - Date, M - Memo ) TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── The following is a list of the fields within the Database and their maximum and minimum limits. Category - This is the listings or categories that all items are placed under. You can have a maximum of 1000 different categories to list your items. This field is automatically inputted as Upper Case and can have a maximum length of 15 characters. Nomenclature - The field is a one-line description of the product. You can describe the product here with a field length of 35 characters. Longer descriptions are available as Extended Descriptions. Cost - Place the cost of the item here. You should include the decimal point. If one is not found, a value of .00 will be appended to your cost. Lastdate - This field is for the date you last updated this item. To insert today's date, highlight the area and press the F6 key. Today's date will automatically be typed in for you. Gif Picture - This field can contain any legal filename. It is used to attach a picture file with the product or even an extra long text file describing the product that the customer can download. If you do not intend on having any file availabe then leave this field blank. Stock Number - This is the manufacturer's stock number - or your specific number for the product. This field can have a length of 25 characters. Manufacture - This is the manufacturer's name and has a field length of 15 characters. Weight - The item's weight - to the nearest pound - is to be placed here. If the item weight is left as 0 LBS, then shipping will not be figured for this item. Markup - This is the percentage of markup the item is to have. For example if your item cost you 10.00 and you wanted a 10% profit on this item you would place a .10 in this field. The formula for this field is calculated as follows: Unit Cost = COST + (Markup * COST) Utilizing this method makes it possible for you to charge different markup costs per item instead of one percentage across the board. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Use Vtax - If the Variable Added Tax configured in Main Menu Item #2 is to be used then place a "Y" here else you may enter a "N" or leave blank. If the field is blank or contains a "N" then the Variable Added Tax will NOT be calculated for this product alone. This is not a global field. Each item is examined individually. Use GST - If the Government Sales Tax configured in Main Menu Item #2 is to be used then place a "Y" here else you may enter a "N" or leave blank. If the field is blank or contains a "N" then the Government Sales Tax will NOT be calculated for this product alone. This is not a global field. Each item is examined individually. Vender - This is the name of the vendor you receive the product from. This field can have a length of 25 characters. Dbversion - This is a field for a version of your Database. Some Users will indicate their first version on start up, and each sub- sequential update as a new version. You may also receive different versions from different vendors, and this field will help you keep track of what version the item came from. Total - This field is updated after the record has been saved with the F10 key. This field contains the Unit Cost times the Markup Value: Total = Cost * Markup 5. PACK Database USE WITH CAUTION - All items marked for deletion in your Database will be removed. Items in databases are not removed until packed to save time. For example, in the database if you see you have 20 total items but only 10 show, then it means you have 10 items that were marked for deletion. They are no longer availabe but still occupy space within the database. Using this option will remove all reference to the deleted items. 6. UPDATE CATEGORIES Update Categories scans through the Index Files and reads all of the current categories you have listed. You may have a maximum of 1000 categories of items. Use this option if you have added or deleted items in the Database. 7. EXPORT Database Export Database writes the contents of your Database to a comma-delimited file with the file name of TSHOP.TXT. This file is in the same format as the file for Importing a Database from a text file (Format listed in the beginning of this section). If you have reason to use your Database TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── in other programs, this option can be used with most other popular programs - dbase III/IV will import a comma- delimited file. For Database structure, see the section concerning Importing a Database. * │ IMPORTANT NOTE: Extended Descriptions can not be imported │ or exported into TeleShoppe since they are contained in │ separate Memo files. * 8. CREATE A Database If the TSHOP.DBF file DOES NOT exist, TCONFIG will create it upon startup. Create a Database is where all the Databases for TeleShoppe are initially created. If you will be creating a Database from scratch, the following commands apply. If you are importing a comma-delimited text file to start your Database, skip to the next section. ____________________________________ Legend: Ques = Question you see on the screen. > = Enter this entry. ____________________________________ CREATING FROM SCRATCH: Ques: Are you creating this Database from a text file? > Enter "N" for No Ques: This will delete any previous TSHOP.DBF file. Are you sure you want to continue? > Enter "Y" for yes * │ NOTE 1: If you have previously created a Database file this │ option will delete and destroy all references to the prior │ Database. Please use this option with care. * │ NOTE 2: You should now proceed to the next section to │ enter Database items. You have created a empty Database. * │ NOTE 3: If you create a Database, the Extended Descriptions │ are replaced with an EMPTY file each time. USE WITH CAUTION * TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── CREATING FROM A COMMA-DELIMITED TEXT FILE: If you are creating a Database from a text file, It must be comma-delimited. (This means that each individual variable must be separated by a comma.) Please make sure before you begin that none of your item descriptions contain commas, as this will disrupt the normal operation of TCONFIG. Your text file must be constructed in the following manner. Each item shall consist of one line and shall be in the following format. (Our lines are broken down because of editing space. Your format should all be on one line.) FieldName Type Size Decimals CATEGORY C 15 N/A NOMENCLA C 35 N/A COST N 15 2 LASTDATE D 8 N/A MARKUP N 10 3 STOCKNO C 25 N/A VENDER C 25 N/A DBVERSION C 15 N/A MANUFACTU C 15 N/A VTAX C 1 N/A GST C 1 N/A WEIGHT N 10 3 GIFNAME C 12 N/A QUANTITY C 6 N/A TAXABLE C 1 N/A DBTEXT M 10 N/A Category[C15], Nomencla[C35], Cost[N2], Lastdate[D], Markup[N3], Stockno[C25], Vendor[C25], DBVersion[C15], Manufactu[C15], Vtax[C1],Gst[C1],Weight[N3],Gifname[C12], Quantity[C6], Taxable[C1] NOTE: Remember that TConfig is not reading in the MEMO field so that field MUST be left off. You should have a total of 12 commas. All entries are read in as TEXT and MUST NOT include Quotes around the text. Cost/Markup are numeric fields and should be imputed as such. Lastdate is a character field and must be in the format of 01/01/1992 (day/mo/yr) or left blank. This field will be used to denote changes in your Database and the date it occurred. Since this is the first day the date will automatically be filled in with today's date if it finds a blank field. Follow the following commands to create a Database from a text file: Ques = Question you see on the screen. > = Enter this entry. Ques: TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Are you creating the Database from a text file? > Enter "Y" for yes Ques: Enter the name of the Database text file. > Enter "Name of your text file" Ques: This will delete any previous TSHOP.DBF file. Are you sure you want to continue? > Enter "Y" for yes If the file is found the record write / reading process is started. If not, you are returned to the Main Menu after being advised that the file was not found. NOTE: The Database has now been created and contains 1 record. You should advance to the next section for editing the Database. NOTE: TeleShoppe Databases are compatible with dbase III record structures. 9. CHECKING OPTIONS You will use this option to setup the defaults for the ATS or other providers checking program. If your not using ATS as a service provider you must check 'N' on the first line entry. Detailed information is listed below on each setup item. Automated Checking Use ATS Check Support - Enter a "Y" if you plan to use the Automated Transaction Services Checking Option. Enter a "N" if using another checking service. Use Other Service - Enter a "Y" here if you are using another checking service to process your checks. Entering a "Y" here will disable all fields not applicable (ATS FIELDS). Registered Company|Name - Enter the name that you registered with ATS. This will be who the check is made out to. Merchant I.D. - Enter your Merchant ID that you received from ATS Marketing here (Maximum of 5 chars) Check Memo field - Enter a description for the check memo field. (ie. Purchased from Compu-Doc Computing!) Enable Check Verify - Verification is the process of verifying Driver License and address information and connecting it to the account number of the bank. It will also verify if the users is on the bad checks writers database before processing the check. (Please check with ATS to ensure you have this option before selecting 'Y'es). TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── Enable Check Guarantee - Guarantee is the value added service of insuring the check if it bounces. (Please check with ATS to ensure you have this option before selecting 'Y'es). Sysop Initials - The Sysop that has the account with Automated Transaction Services should enter thier initials here. Do you have a Merchant or Production Account - Enter a M for Merchant account or P for Production. A merchant account is one that has a paper trail, A production account is a paperless trail account that allows inputing funds into your bank account automatically. Com Port - Select the com port that the TELESEND program will use to send the databases to ATS. IRQ - Select the IRQ that is set for your machine. This is the port that TELESEND will use. Baud Rate - Select the baud rate that your modem will operate at when using the TELESEND program. Port Address - Select the appropriate port address for the port that TELESEND will use. Phone Num - Enter the phone number to dial for the ATS check service. Login Name - Enter your login name for the ATS system. Only First and Last Name are needed. Your account number is your password. Conference Number - Enter the conference number on the ATS bbs to join prior to uploading your database files. Modem Setup - If your modem requires a setup string, enter it here. This string will be sent to the modem prior to calling the ATS system. Path where check database's should be located: - This is where ATS databases will be stored until they have been sent to ATS Marketing for processing. Path where ATS databases should be archived - This is the directory where the ZIPPED ATS databases should be archived once they have been uploaded to the ATS receiving station. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── 10. EXIT PROGRAM Using this option should be the only way you exit TCONFIG to DOS. Rebooting the machine while TCONFIG is running could cause damage to your Database and Index Files. TCONFIG clears memory and closes all files that it opened when exited properly. END DOCUMENTATION FOR TCONFIG.EXE TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── TeleShoppe Main Menu (On-Line) Welcome to the TeleShoppe Online store. We hope that your Users will find this program simple and easy to use, and that you will find it easy and versatile. When first starting up TeleShoppe from your Bulletin Board System you are presented with the opening screen. If you registered your version of TeleShoppe, you may design your own opening screens. (See Item #1 of the TCONFIG program). ┌───────────────────────────────────┐ ││ eleShoppe Online Shopping Store ┴┴ (tm) Special Edition 02 ┌─────────────────────────────────────────────┐ │ Copyright (c) 1991-96 Compudoc Consulting │ │ All Rights Reserved │ │ │ │ Support BBS: (804) 468-1783/1492/1386 │ └─────────────────────────────────────────────┘ The Main Menu consists of 8 different selections. From it, your Users may move throughout the TeleShoppe program, creating and modifying their choices.We will discuss each of these items in detail, describing their full potential. We will also describe their intended functions. ┌───────────────────────────────────┐ ││ eleShoppe Online Shopping Store ┴┴ ┌──────────────────────────────────┐ │ 1) List Items by Category │ │ 2) Edit Marked Items │ │ 3) View Marked Items │ │ 4) Show a Quote │ │ 5) Download a Quote │ │ 6) Order Selected Items │ │ 7) Instructions (Text) │ │ 8) Return to Main Board │ └──────────────────────────────────┘ TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── 1. LIST ITEMS BY CATEGORY Selecting this option will present the User with the categories you have setup in your Database file. The User will be allowed to choose from this screen the items that they wish to view. This is done automatically each time and does not require that the operator design a screen each time a category is either created or deleted. Categories ──────────────────────────────────────────────────────────────────── 1 A.D.A.M. SOFTWA 16 ADIC (ADVANCED 2 ABACUS CONCEPTS 17 ADOBE (ACADEMIC The above screen is presented to the User. The User has the option of searching for a keyword item in the Database, Viewing a category or typing "F" to return them to the Main Menu. NOTE: If you have updated your Database listing and do not see *new* categories you may have just entered, run the TCONFIG program and run the option for "Update Categories" SEARCH - The search function will ask the User Enter the string to search for: At this prompt, the User should enter the string to search for. If the User types in DRIVE, TeleShoppe will search through the entire Database until all descriptions with the word drive have been shown to the User, or it reaches the end of the Database. The User can stop the search at any time by pressing CTRL + K. The User may also end the operation by pressing A)bort. This will allow the User to either V)iew the extended description of the item or select the item for marking. If the User elects to view a CATEGORY by number the User will be presented with a screen of information regarding the entries within that category. -=* LOOK! *=- If you have created what we call CATEGORY SCREENS the user will be presented with that screen before the database is shown. These files must be located in the subdirectory off of TSHOP named CATPIC. If the first 7 or less characters are matched ie, bar code (Strips down to barcode), it will be shown to the user prior to entering the database showing area. The listing the User sees will list the item number as it corresponds to the record number in the Database, item description, and unit cost. This cost is a total of (Cost * Markup) + Cost. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── ──────────────────────────────────────────────────────────────────────────── TeleShoppe ┌──── Item has a picture available for download (@) │ ┌── Item has extra information available (√) Num. Manufacture │ │ Item Listing Price ──────────────────────────────────────────────────────────────────────────── 1 A.D.A.M. SOFTWA √ A.D.A.M THE INSIDE STORY 47.15 2 A.D.A.M. SOFTWA √ A.D.A.M. THE INSIDE STORY 47.15 V) View Description Enter) View more Items F) Finished D) Download Picture Num) Select Item by Number Enter Selection? ──────────────────────────────────────────────────────────────────────────── The User now has the option of pressing enter which will view more items if they are available within this category, "V" for viewing the extended description: When viewing a extended description, a portion of the screen is cleared so the full ten lines allowed are shown to the User. ──────────────────────────────────────────────────────────────────────────── TeleShoppe ┌──── Item has a picture available for download (@) │ ┌── Item has extra information available (√) Num. Manufacture │ │ Item Listing Price ──────────────────────────────────────────────────────────────────────────── 1 A.D.A.M. SOFTWA √ A.D.A.M THE INSIDE STORY 47.15 2 A.D.A.M. SOFTWA √ A.D.A.M. THE INSIDE STORY 47.15 -------------------------------------------------------------------- Extended Description for item number 1 A.D.A.M THE INSIDE STORY ABOUT ADAM THE PUPPY DOG. THIS IS A GREAT ITEM FOR YOUR CHILDREN...ETC.. If no extended description is available, TeleShoppe will inform the User know that no additional information is available. Once the User is done viewing the description they will press enter and the screen will be replaced with the Database information again. NOTE: If the User is doing a SEARCH and then does a view on an item the screen information that was erased IS NOT redrawn. If the User decides to mark an item, then the User will insert the item number on the line. I.E., to mark item number 101, the User would enter: If the User enters a number for an item, that number will be placed in a buffer so that the User can view/edit that item later without remembering which number they desired to view. The User will then be asked for the quantity of the item they wish to purchase. The User should enter the quantity of the item they wish to purchase: Item number 101 marked, Enter quantity desired: 3 After entering the Quantity the user will be asked for addition details about the product if desired. This could include information such as size, color etc... TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── If there is a @ in the appropriate column, indicating that there is a file availabe for download, the user will select D and then be able to download that particular file. To end the viewing of a category the User will select "F" to back up or <RETURN> until the end of the category is reached. Once at the category screen, the User may enter "F" to return to the Main Menu. 2. EDIT MARKED ITEMS This choice allows the User to revise what they originally marked when viewing the items. The User may either keep or discard the items, or change the quantity they wish to order. When pressing #2, the User is presented with their listing of items in the following manner. ┌──────────────────────────────────────────────────────────────────┐ │Editing Mode Unit Extended │ │Number Item Listing Price Qty Price │ └──────────────────────────────────────────────────────────────────┘ 1 Accessories VGA Adapter 12.00 This item marked for purchase. Keep it? (Y/n) If the User desires to keep the item, they enter "Y" (or return) to keep the item (Default is Yes). The User is then asked if the quantity is correct, or to enter the correct amount. If the User keeps the item, it is displayed in order at the top of the screen. If the User decides to discard the item, it is removed form the marked listing and is no longer shown. This process is continued until all items marked for purchase have been covered. Once completed, the User will now have a valid list of items and quantities - and can prepare to view an Invoice or purchase the items. The User is placed back at the Main Menu after completion. 3. VIEW MARKED ITEMS Selecting item 3 will allow the User to VIEW quickly (NOT EDIT) the items they have marked for purchase. When this is selected the screen is cleared the following headings are presented to the User: ┌──────────────────────────────────────────────────────────────────┐ │Viewing Mode Unit Extended │ │Number Item Listing Price Qty Price │ └──────────────────────────────────────────────────────────────────┘ Once a User has viewed all the flagged items, Pressing return will return them back to the Main Menu. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── 4. SHOW Invoice Quote: This item is unique in that a User can view an actual Quoted Invoice prior to paying for any item. By selecting this option, a Quote is created from the items a User has selected and then displayed to the User. This Quoted information is deleted after the User departs the door. NOTE: No handling charges or shipping information is shown to the User during a Quote. NOTE: See Creating RECEIPT.TXT for information on creating your Invoice and receipts. 5. DOWNLOAD Quoted Invoice: With the Download Quoted Invoice option, Users may download a Quoted Invoice once they have created one by selecting items. When selecting this option the User will be presented with a screen to select their desired protocol to download the Quoted Invoice. ┌──────────────────────────────┐ │ ┌──────────────────────────┐ │ │ │ ┌────────────────────┐ │ │ │ │ │ Select Protocol │ │ │ │ │ └────────────────────┘ │ │ │ │ 1) Zmodem │ │ │ │ 2) Ymodem │ │ │ │ 3) Xmodem │ │ │ │ C) ancel │ │ │ └──────────────────────────┘ │ └──────────────────────────────┘ Enter Selection: Once the User selects the protocol, the screen will tell them that the INV_<NODE>.TXT file is ready for download, Once the User presses a key the download with that protocol will transfer the Quote. When the download is complete if it is successful the User is put back at the Main Menu, If the transfer was unsuccessful or canceled the User is brought back to this menu for further processing. 6. ORDER SELECTED ITEMS The Order Selected Items option is the heart of the TeleShoppe on-line system. In this section, your Users will select their type of payment desired, enter their personal information, and order the items that they have previously marked for purchase. When the User first selects item 6, a warning screen (either the default one provided with TeleShoppe or a User defined screen) is shown to the User. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── NOTE: The information in the warning file should contain as much information about fraudulent use of credit cards as possible to attempt to ward off any potential abUsers. Next, the User is presented the menu to select the type payment. You have previously defined these options in TCONFIG. If all payment types were selected in TCONFIG then the User will be presented with the following menu (Or a similar menu depending on services provided). ┌────────────────────────────────────┐ │ ┌────────────────────────────────┐ │ │ │ Preferred Payment Type │ │ │ │ │ │ │ │ 1) Credit Card │ │ │ │ 2) Cash on Delivery (COD) │ │ │ │ 3) Check │ │ │ │ C) ancel │ │ │ │ │ │ │ └────────────────────────────────┘ │ └────────────────────────────────────┘ The User should select their preferred method. Once this is complete the User is presented with the Data Entry screen where all the personal information is entered. If the User selected the Credit Card payment type, their number is entered and then automatically checked by TeleShoppe. The only credit cards allowed are the ones you defined in the TCONFIG program. ┌───────────────────────────────────────────────────────────────────── │ I NOTE: TeleShoppe makes use of a file name "TRASHCAN" which │ M contains the numbers of credit cards that are not accepted by your │ P system. They filename MUST be TRASHCAN and there should be no │ O spaces or other characters in the number. i.e.,... │ R │ T 0034-0099-3433-9393 illegal │ A 0034 0099 3433 9393 illegal │ N 0034009934339393 acceptable │ T │ This file MUST exist in the TeleShoppe directory. └───────────────────────────────────────────────────────────────────── If either of the other options is selected, then the User is only prompted for Name, Address, etc.. Once all the personal data is entered, the User is given the chance to change any information that was entered. The only information not allowed to be changed is a validated credit card number. (This is to prevent tampering.) After all the data is entered and is correct the User will enter "C" to continue with the purchase. The Purchase menu is next presented to the User. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── ┌────────────────────────────────────┐ │ ┌────────────────────────────────┐ │ │ │ Purchase Menu │ │ │ │ │ │ │ │ 1) Mark items for purchase │ │ │ │ 2) Edit marked list │ │ │ │ 3) View marked list │ │ │ │ 4) Continue with Purchase │ │ │ │ 5) Cancel, Return to Menu │ │ │ │ │ │ │ └────────────────────────────────┘ │ └────────────────────────────────────┘ This menu is almost the same as the Main Menu. It allows the User to go back to the viewing and marking section, or to re-edit their purchases before proceeding. When completed with this menu the User will select #4 to continue or #5 to back out of this area completely. (The items still remain marked for the User). When continuing, the User is present the final copy of the Invoice, This Invoice will contain all taxes, shipping and handling charges and shows the EXACT amount the User will be charged. After viewing this Invoice the User is once again asked for final verification. (Some Users are really timid around this point - these extra steps are to make them feel more comfortable in knowing they are in complete control of the sale). ┌──────────────────────────────┐ │ ┌──────────────────────────┐ │ │ │ ┌────────────────────┐ │ │ │ │ │ Final Verification │ │ │ │ │ └────────────────────┘ │ │ │ │ │ │ │ │ Enter (Y)es to finalize │ │ │ │ Enter (C) to cancel │ │ │ │ │ │ │ └──────────────────────────┘ │ └──────────────────────────────┘ Upon selecting (C) the User would be placed back at the Main Menu and no transactions would take place. If the User selects (Y) then the Invoice is created, the Sales Receipt is created and the User is placed at the download menu once again. This gives the User the chance to download the menu. After downloading the User will be returned to the Main Menu. TeleShoppe SE02 ────────────────────────────────────────────────────────────────────────── 7. INSTRUCTIONS The Instructions command helps with any of TeleShoppe's features a User may be having problems understanding. This is a scrolling text file (TSHOP.INS) that may be (and should be) edited by the Sysop. If you have any special instructions for your customers you should place it in this file. (You may want to put shipping times, etc. in this file.) 8. RETURN TO MAIN BOARD Use this option to return to the Bulletin Board. When this option is selected, All files are closed and communication monitoring is once again turned over to the bulletin board program. This should be the only way that TeleShoppe is exited. END OF TeleShoppe DOCUMENTATION TeleShoppe SE02 APPENDIX A ────────────────────────────────────────────────────────────────────────── APPENDIX A TRASHCAN FILE The trashcan file is a listing of ALL credit card numbers that you do not wish to have access to your products. If a credit card number is placed in this file then the User of that card will be informed that their information is invalid and it will be reported. This file has a format of one number per line. There should be NO spaces or other characters between the numbers. ex. 1234567812345678 The file name of this file is TRASHCAN and can not be changed. It is a text file, so you may use your favorite text editor to edit the file. the file MUST exist. TeleShoppe SE02 APPENDIX B ────────────────────────────────────────────────────────────────────────── APPENDIX B Invoice INFORMATION Your Invoice files are created with the title of # and a suffix of .INV, for example, your 21st order will be labeled "21.INV" and will be in your TSHOP\INV directory. These files are written in a numerical sequence. If you wish to start with a higher number, edit the TSHOP.CNT file (Also located within the INV sub-directory) with an ASCII editor and place the number you wish to begin with inside of this file. (It must be a numeric input) It is not within the scope of this document to describe procedures for processing your Invoices. Your credit card merchant should provide this information for you. A file with the name of PURCHASE.NODE is written to the default TeleShoppe directory each time an Invoice is create (i.e.,.. a purchase has taken place). This file contains a message that a purchase has taken place. It is up to the sysop to process this file after the User finishes with TeleShoppe. May we suggest that you use Txt2msg to write the message to your PCBoard conference and then delete the file prior to returning to the board. TeleShoppe SE02 APPENDIX C ────────────────────────────────────────────────────────────────────────── APPENDIX C COMMUNICATIONS The Invoices and Quotes may be downloaded by your Users. TeleShoppe makes use of the DSZ communication software. This file (DSZ) must exist in the path if TeleShoppe is to work properly. The batch files TxZ.BAT may be modified to suit your BBS software. For those of you that understand Ports and IRQ settings! NOTE: If you need to specify a non-standard port address and IRQ, then the syntax is PORT:AAAA:X where AAAA is the base address and X is the IRQ. It doesn't matter whether PORT:AAAA:X is the third or fourth parameter as long as it is the LAST parameter passed. PORT is optional, and TeleShoppe will default to standard addresses and irqs if it not used based on the port number read from the BBS file. TeleShoppe will assume COM1 = 03F8 IRQ 4, COM2 = 02F8 IRQ3, COM3 = 03E8 IRQ4 and COM4 = 02E8 IRQ 3. If you have a different non-standard port address and irq, you could then use the PORT cmd to change the defaults. TeleShoppe will also support the use of FOSSIL drivers. The syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells TeleShoppe to use a Fossil driver for it's communications. The 'P' following it tells it which port to use for the Fossil. Example - PORT:F:1, tells TeleShoppe to use a fossil driver for port 1. Digiboard Intelligent Async boards are supported thru the Universal DOS driver for Digiboard. The syntax is the same as the Fossil driver except you replace the F with D and give the channel number to use. Example - PORT:D:6 tells TeleShoppe that it is connected to a Digiboard and to use channel 6 on the Digiboard. Your program's cmd line for the above could be any one of the following: Tshop door.sys ;Using standard ports Tshop door.sys PORT:03E8:5 ;Using non-standard port Tshop door.sys PORT:D:5 ;Using Digiboard channel 5 Teleshoppe also support IRQ's 8-15. If you are using com 1 and 2 and add 3 your TSHOP batch could possibly look like the following example: D: CD \pcb\doors\tshop IF %PCBNODE% == 1 TSHOP %PCBDRIVE%%PCBDIR%\door.sys IF %PCBNODE% == 2 TSHOP %PCBDRIVE%%PCBDIR%\door.sys IF %PCBNODE% == 3 TSHOP %PCBDRIVE%%PCBDIR%\pcboard.sys PORT:03E8:5 IF %PCBNODE% == 4 TSHOP %PCBDRIVE%%PCBDIR%\door.sys %PCBDRIVE% CD %PCBDIR% The above batch example use's PCBNODE enviornment variable to deterimine which node is in use and what communication parameters are required. TeleShoppe SE02 APPENDIX D ────────────────────────────────────────────────────────────────────────── APPENDIX D CREATING INVOICE.TXT AND RECEIPT.TXT You can now create your own Invoice and receipt files using the @ codes. To use these codes you just place them in a normal text file, and TeleShoppe will replace your @code with the appropriate information. i.e.,. In your Invoice file you place: Our Bulletin Board Name is @BOARD@ The User will receive: Our Bulletin Board Name is Random Access! The following @ Codes may be used to format your Invoices and receipts. (For examples, see the Invoice.TXT and RECEIPT.TXT files supplied.) NOTE: that items marked with * are stripped if there is no info, for example - if you @VTAX@ on a line and there is no variable tax for this purchase then this line is stripped out of the Invoice/receipt file. DO NOT put any thing on this line that should not be stripped out if the item does not apply. @BBSFNAME@ Full Name used on BBS @BOARD@ BBS Name @DATE@ Todays Date @TIME@ Present Time @CARDTYPE@ Card Type (Mastercard, Visa Etc) @CCNAME@ Name entered from User as Purchaser @STREET@ Street Address @CITY@ City @STATE@ State @ZIP@ Zipcode @HPHONE@ Home Phone @WPHONE@ Work Phone @PROCESSOR@ Merchant Processor Name @CARDNUMBER@ Credit Card Number (Formatted) @TAXSTATE@ State to charge tax @CCEXPIRE@ Credit Card expire date @TYPEORD@ Type of Purchase (Credit card, CheckMO, COD) @SHIPTYPE@ Shipping vendor name @INVNO@ Invoice Number (Between 1 and 32767) @ITEMS@ Items ordered. These items are formated. create an Invoice or Receipt to see the format. ITEMS MUST BE CALLED BEFORE ANY OF THE FOLLOWING FIELDS. @SUB_TOTAL@ Subtotal of ITEMS (Call after ITEMS ONLY) @BREAK@ Break Point cost (Call after ITEMS ONLY) TeleShoppe SE02 APPENDIX D ────────────────────────────────────────────────────────────────────────── @TAX@ Tax amount (Call after ITEMS ONLY) @VTAX@ Variable Tax (Call after ITEMS ONLY) @SHIPPING@ Amount of Shipping (Call after ITEMS ONLY) @HANDLING@ Amount of handling (Call after ITEMS ONLY) @TOTAL@ Final Total (Call only after all above) @CKTYPECKACT@ Type of Checking Account (Business|Personal) @CKCOMPANY@ Company Name on Checking Account @CKF_NAME1@ Primary First Name on Check @CKF_NAME2@ Secondary First Name on Check @CKL_NAME1@ Primary Last Name on Check @CKL_NAME2@ Secondary Last Name on Check @CKAUTHNAME@ Authorized Signature Name @CKCHECKNO@ Check Number @CKROUTENO@ Routing Number on Check @CKACT@ Checking Account Number @CKMEMO@ Memo on Check @CKDLNUM@ Users Drivers License Number @CKSSN@ Users Social Security Number @DATE0@ Date in the format of December 3, 1995 @DATE1@ Date in the format of 3 Dec 95 @DATE2@ Date in the format of 12-3-95 @DATE3@ Date in the format of 12/3/95 @DATE4@ Date in the format of 3/12/95 @DATE5@ Date in the format of 3 December 1995 @GST@ Amount of GST charged @PST@ Amount of PST charged @BANKNAME@ Name of users bank @BANKSTREET@ Street address of users bank @BANKCITY@ City of users bank @BANKSTATE@ State of users bank @BANKZIP@ Zipcode of users bank @BANKPHONE@ Business phone number of users bank @UPPERABA@ Fractional number on top right of check Part1 @LOWERABA@ Fractional number on top right of check Part2 @TAXEXEMPTNO@ Users Tax Exemption Number TeleShoppe SE02 APPENDIX E ────────────────────────────────────────────────────────────────────────── APPENDIX E The following are @ color codes availabe within TeleShoppe. All text files and menus use these codes and may be edit with your favorite text editor or with PCBEDIT, or THEDRAW. With the draw save using the @ PCBoard format. (Note: THEDRAW allows two color codes to be side by side (ex. @X07@X08) in this case only the first is used and the second is considered to be text..remove all cases of this if found. In PCBEDIT, pressing ALT-O will optimize the file for you). COLOR BACKGROUND | FOREGROUND NORMAL BLINKING | NORMAL BRIGHT | BLACK 0 8 | 0 8 BLUE 1 9 | 1 9 GREEN 2 A | 2 A CYAN 3 B | 3 B RED 4 C | 4 C MAGENTA 5 D | 5 D YELLOW 6 E | 6 E WHITE 7 F | 7 F With the color table provided you can quickly determine any color pattern. Below are a couple of examples. (Remember all color codes are prefixed with the @X symbols) @X07 - Dull white (light grey) text on a black background @X47 - Dull white on a red background @X8F - Bright white on a blinking black background @X0F - Bright white on a black background. TeleShoppe SE02 APPENDIX F ────────────────────────────────────────────────────────────────────────── TELESEND PROGRAM TeleSend is a telecommunications program that will send your checks from TeleShoppe to the ATS collection bulletin board automatically every day in an event or when ever you like. TeleSend will be found in your default TSHOP directory. The only other necessary piece of software required is PKZIP which can be found on any bulletin board. PKZIP *MUST* be able to be found within your path. If not you will receive an error telling you that TeleSend can not find PKZIP. TeleSend will send only one database at a time so it is necessary if you create more than one database a day to place TeleSend in a loop within a batch file. An example of a batch file used would be as follows: TSEND.BAT @echo off cd \pcb\doors\TSHOP :start TeleSend d:\pcb\doors\tshop 5 if exist *.dbf goto start This batch file first turns echoing off, the :start is a label that will tell the batch file where to go to if a certain condition is met. The next line is the TeleSend command line (discussed below) and the next line tells the batch file that if any files with the extention of .dbf exist within that directory to then go to the start label and run until all the .dbf files have been remove. TeleSend requires a couple of command line parameters to operate. The structure of that command line is: TeleSend <Path to TSHOP DIR> <# of Attempts to call> <[debug]> TeleSend is the excutable filename to be executed Path to TSHOP Dir - Place the complete path to your TSHOP directory. TeleSend must be able to find the TSHOP.CNF file # of Attempts - Enter the number of tries you want TeleSend to attempt in connecting with the ATS system. TeleSend will call if busy until all the number of attempts has expired. TeleShoppe SE02 APPENDIX F ────────────────────────────────────────────────────────────────────────── <[debug]> - This option will allow you to view what is going on underneath the TeleSend program. Normally, TeleSend will only show you what is happening but if you need to view the exact operation of TeleSend you can place a 1 in this position and the screen will be split and allow you to see TeleSend in operation and also view any errors if one occurs. TeleSend puts the BBS (PCBoard) into what is know as TERSE mode. These are codes that tell TeleSend exactly where it is no matter what prompt the sysop uses. Examples: TeleSend C:\PCB\DOORS\TSHOP 5 (The above line will have TeleSend call the ATS system 5 times. The home directory for TeleShoppe is in the TSHOP directory) TeleSend C:\PCB\DOORS\TSHOP 3 1 (The above will attempt to connect 3 times before quitting. This will also turn on the debug function so you can see what is going on during the call. -------------------------- Example of TeleSend script -------------------------- TeleSend Copyright(C) 1995 CompuDoc Consulting (v1.0) For EXCLUSIVE use with TeleShoppe Version SE 02 and ATS Systems. (Initializing Modem) Dialing ATS BBS Connecting.... Logging in as Gary Smith xxxxx! Joining Conference 10 (Success) Sending Upload Command Uploading File Description Uploading Database (via Internal Zmodem) Upload of Database Successful, Logging Off... Moved Database file to Archive |-- In the above script, TeleSend connects with the ATS system after initializing the modem and sending the dialing string. You will see the "connecting..." string once carrier has been established. Next when your name is prompted, your Name and Password are sent to the ATS system. TeleSend then attempts to join the apppropriate conference you set in the Tconfig program, upon success you will see the string "(Success)". This ensures that TeleSend is in the right conference for the upload. Next TeleSend attempts to inform the ATS system that it has a file to upload. Once acknowledged, TeleSend sends the description of that file to the ATS system and then using our Internal ZMODEM will upload your Zipped Database file to the ATS System. TeleSend will either return a successful upload or Unsuccessful upload. TeleShoppe SE02 APPENDIX F ────────────────────────────────────────────────────────────────────────── If the upload was successful, the Zipped database file is moved to your archive directory and the xxxxxxx.dbf file is removed from the system to avoid the possibility of uploading it again. If the upload was Unsuccessful, the Zipped Database is removed from the system and the xxxxxxx.dbf file is left intact and ready for the next attempt. You do not have to use the ATS system to accept checks (However we highly recommend it!). Your information for processing checks is maintained in your ####.INV file (See the example INVOICE.TXT template file located in your TSHOP main directory)